home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat2 / standard / clock_settime.z / clock_settime
Encoding:
Text File  |  1998-10-20  |  7.5 KB  |  133 lines
  1.  
  2.  
  3.  
  4. PPPPCCCCLLLLOOOOCCCCKKKK((((2222))))                                                            PPPPCCCCLLLLOOOOCCCCKKKK((((2222))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      clock_settime, clock_gettime, clock_getres - get/set date and time
  10.      (POSIX)
  11.  
  12. CCCC SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ttttiiiimmmmeeee....hhhh>>>>
  14.  
  15.      iiiinnnntttt cccclllloooocccckkkk____sssseeeettttttttiiiimmmmeeee((((cccclllloooocccckkkkiiiidddd____tttt cccclllloooocccckkkk____iiiidddd,,,, ccccoooonnnnsssstttt ssssttttrrrruuuucccctttt ttttiiiimmmmeeeessssppppeeeecccc ****ttttpppp))));;;;
  16.      iiiinnnntttt cccclllloooocccckkkk____ggggeeeettttttttiiiimmmmeeee((((cccclllloooocccckkkkiiiidddd____tttt cccclllloooocccckkkk____iiiidddd,,,, ssssttttrrrruuuucccctttt ttttiiiimmmmeeeessssppppeeeecccc ****ttttpppp))));;;;
  17.      iiiinnnntttt cccclllloooocccckkkk____ggggeeeettttrrrreeeessss((((cccclllloooocccckkkkiiiidddd____tttt cccclllloooocccckkkk____iiiidddd,,,, ssssttttrrrruuuucccctttt ttttiiiimmmmeeeessssppppeeeecccc ****rrrreeeessss))));;;;
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      The _cccc_llll_oooo_cccc_kkkk______ssss_eeee_tttt_tttt_iiii_mmmm_eeee_((((_)))) function sets the specific clock, _c_l_o_c_k__i_d, to the
  21.      value specified by _t_p. Time values that are between two consecutive non-
  22.      negative integer multiples of the resolution of the specified clock are
  23.      truncated down to the smaller multiple of the resolution.
  24.  
  25.      The _cccc_llll_oooo_cccc_kkkk______gggg_eeee_tttt_tttt_iiii_mmmm_eeee_((((_)))) function returns the current value _t_p for the
  26.      specified clock, _c_l_o_c_k__i_d. Depending on the clocks resolution, it may be
  27.      possible to obtain the same time value with consecutive reads of the
  28.      clock.
  29.  
  30.      The resolution of any clock can be obtained by calling the _cccc_llll_oooo_cccc_kkkk______gggg_eeee_tttt_rrrr_eeee_ssss_((((_))))
  31.      function. The resolution of the clock will be returned in _r_e_s. If _r_e_s is
  32.      NULL, then the resolution of the clock will not be returned.
  33.  
  34. CCCCLLLLOOOOCCCCKKKKSSSS
  35.      Supported clocks for _c_l_o_c_k__i_d are
  36.  
  37.      _CCCC_LLLL_OOOO_CCCC_KKKK______RRRR_EEEE_AAAA_LLLL_TTTT_IIII_MMMM_EEEE The system's notion of the current time is obtained with
  38.                     this clock.  The time is expressed in seconds and
  39.                     nanoseconds since midnight (00:00) Coordinated Universal
  40.                     Time (UTC), January 1, 1970.  The resolution for of this
  41.                     clock is never worse than 100 HZ (which equals 10
  42.                     milliseconds).  The actual resolution of the clock depends
  43.                     on the timer capability of the underlying hardware(see
  44.                     timers(5)).
  45.  
  46.      _CCCC_LLLL_OOOO_CCCC_KKKK______SSSS_GGGG_IIII______CCCC_YYYY_CCCC_LLLL_EEEE
  47.                     This clock allows easy access to the free running hardware
  48.                     counter.  This SGI specific clock maps the counter into
  49.                     the application address space and returns the current
  50.                     value. Handling of the counter wraps on machines with
  51.                     small counters is left to the application. To find the
  52.                     number of bit the counter supports the application may
  53.                     call _ssss_yyyy_ssss_ssss_gggg_iiii_((((_)))) with the _SSSS_GGGG_IIII______CCCC_YYYY_CCCC_LLLL_EEEE_CCCC_NNNN_TTTT_RRRR______SSSS_IIII_ZZZZ_EEEE request.  This
  54.                     clock only is usable as a _c_l_o_c_k__i_d for the _cccc_llll_oooo_cccc_kkkk______gggg_eeee_tttt_tttt_iiii_mmmm_eeee_((((_))))
  55.                     and _cccc_llll_oooo_cccc_kkkk______gggg_eeee_tttt_rrrr_eeee_ssss_((((_)))) functions. This clock is SGI specific
  56.                     and is not portable.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PPPPCCCCLLLLOOOOCCCCKKKK((((2222))))                                                            PPPPCCCCLLLLOOOOCCCCKKKK((((2222))))
  71.  
  72.  
  73.  
  74.      _CCCC_LLLL_OOOO_CCCC_KKKK______SSSS_GGGG_IIII______FFFF_AAAA_SSSS_TTTT This clock has a higher resolution than _CCCC_LLLL_OOOO_CCCC_KKKK______RRRR_EEEE_AAAA_LLLL_TTTT_IIII_MMMM_EEEE and
  75.                     is available to privileged users only.  This clock only is
  76.                     usable as a _c_l_o_c_k__i_d. for the _cccc_llll_oooo_cccc_kkkk______gggg_eeee_tttt_rrrr_eeee_ssss_((((_)))) and
  77.                     _tttt_iiii_mmmm_eeee_rrrr______cccc_rrrr_eeee_aaaa_tttt_eeee_((((_)))) functions. This clock is SGI specific and
  78.                     is not portable.
  79.  
  80. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  81.      date(1), time(2), stime(2), ctime(3C), gettimeofday(3c),
  82.      settimeofday(3c), and syssgi(2).
  83.  
  84.  
  85. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  86.      The cccclllloooocccckkkk____sssseeeettttttttiiiimmmmeeee(((()))), cccclllloooocccckkkk____ggggeeeettttttttiiiimmmmeeee(((()))), and cccclllloooocccckkkk____ggggeeeettttrrrreeeessss(((()))) return a value
  87.      of 0 to the calling process if the operation is successful; otherwise the
  88.      functions shall return a value of -1 and shall set _e_r_r_n_o to indicate the
  89.      error
  90.  
  91.      [EINVAL]       The _c_l_o_c_k__i_d argument is not a know clock.
  92.  
  93.      The cccclllloooocccckkkk____sssseeeettttttttiiiimmmmeeee(((()))) call also supports the following values for _e_r_r_n_o
  94.  
  95.      [EINVAL]       The _t_p argument is outside the range for the given
  96.                     _c_l_o_c_k__i_d , or the _t_p argument specified a nanosecond value
  97.                     less then zero  or greater then or equal to 1000 million
  98.  
  99.      [EPERM]        The requesting process does not have the appropriate
  100.                     privilege to set the specified clock.
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.